home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 1: Comms & Networking / Almathera Ten on Ten - Disc 1: Comms & Networking.iso / tools / archie / archie-1.4 / readme.dos < prev    next >
Text File  |  1995-05-01  |  11KB  |  273 lines
  1. 11/22/91  Readme.dos -- Readme file for CUTCP DOS version of Archie.
  2.  
  3. --
  4. This version requires the use of a `standard' NCSA or CUTCP compatible
  5. CONFIG.TEL file.  If you are running NCSA telnet or CUTCP/CUTE telnet,
  6. you should be able to run this program without modification.
  7.  
  8. As with all CUTCP programs, you may set a DOS environment variable to
  9. point to the location of your config.tel file.
  10.  
  11.     set CONFIGTEL=C:\net\config.tel
  12.  
  13. You may also set the $CUTCPnn dos environment variables to include other
  14. 'local' information (such as client IP address on a Novell lan).
  15.  
  16. This version has been compiled with the US (archie.sura.net) Prospero/Archie
  17. server as the default. This may not be appropriate for your location. Here's
  18. how to change it.
  19.  
  20.  
  21.     1. Run the archie program with the -L argument to list known
  22.        archie/prospero servers.
  23.  
  24.     2. Select the server name that is closest to your site. For this example
  25.        we'll pick archie.funet.fi
  26.  
  27.     3. Edit your config.tel file and add the following lines at the end
  28.        of the file.
  29.  
  30.             name=archie
  31.             host=archie.funet.fi    # actually substitute your select
  32.                         # server name here
  33.  
  34.     4. If you happen to know the IP address of the server, you may also
  35.        add the appropriate
  36.  
  37.             hostip=<insert IP address here>
  38.  
  39.     5. If you don't enter an IP address, archie will perform a DNS lookup
  40.        use the domain nameserver information that is in your config.tel 
  41.        file.
  42.  
  43.  
  44. An additional command line option (-H) has been added (vs -h) to allow the
  45. user to specify the config.tel file location on the command line. 
  46.  
  47.     archie -H c:\net\config.tel emacs
  48.  
  49. During a search, you may press the <ESCAPE> key to abort the query.
  50.  
  51.  
  52.  
  53. If you have problems, try running archie with the -D9 option (debug).
  54.  
  55. As usual, bugs/comments to:
  56.  
  57.         cutcp-bugs@omnigate.clarkson.edu
  58.  
  59. Brad Clements, Sr. Network Engineer
  60. Educational Resources Center
  61. Clarkson University 
  62. Potsdam, NY 13699
  63.  
  64. bkc@draco.erc.clarkson.edu
  65.  
  66. -----------
  67. Sample Config.tel file 
  68. ------------------------------
  69. #  Example host file for ARCHIE/ CUTCP version
  70. #  11/21/91
  71. #
  72. #      Bugs to  cutcp-bugs@omnigate.clarkson.edu
  73.  
  74. #---------------------------------------------------------------------------#
  75. #                                        #
  76. #** ATTENTION ATTENTION ATTENTION ATTENTION ATTENTION ATTENTION ATTENTION **#
  77. #                                        #
  78. #   This sample config.tel file contains every single option that you could #
  79. #   possibly use. Its meant as an example only. Please Please PLEASE don't  #
  80. #   use all these options in your working config.tel file, just the ones    #
  81. #   that you actually need. Many options can be left out, the default action#
  82. #   (if defined) is shown in parens () next to the option.             #
  83. #                                        #
  84. #                         Thank you for your support                #
  85. #---------------------------------------------------------------------------#
  86.  
  87. #
  88. #  This example file is for my=bootp, in which case the following items are
  89. #  determined from the bootp server: (and are thus commented out in this file)
  90. #       1. This machine's IP Address
  91. #       2. The network NETMASK
  92. #       3. The default gateway (one or more)
  93. #       4. Nameservers (one or more)
  94. #       5. The domain search list (if this clients hostname is in the bootp packet)
  95. #
  96. #  Your BOOTP server needs to be RFC 1048 compliant for this to work
  97. #  
  98. #  If you have nameservers, gateways or a domainslist already specified
  99. #  in this file, then the file's entry takes precedence.
  100. #  Extra gateways and nameservers will be added by BOOTP if found, however.
  101. #----------------------------------------------------------------------------
  102. #  You can set a DOS environment variable  CONFIGTEL to point to this file
  103. #  then you don't need batch files or the -h option.
  104. #
  105. #       C> set CONFIGTEL=C:\net\myconfig.tel
  106. #
  107. #  You may also use environment variables to include config.tel options,
  108. #  such as:
  109. #    C> set $CUTCP1=myip~197.001.42.98;netmask~255.255.252.0
  110. #    C> set $CUTCP2=name~x;hostip~128.163.298.2
  111. #
  112. #  and so on up to $CUTCP99. Note that you use a tilde (~) instead of (=)
  113. #  in the dos set command because two ='s are not allowed by Dos.
  114. #
  115. #  Additionally, there is a new config.tel option called include= which
  116. #  allows the nesting (up to 3) configuration files deep.
  117. #
  118. #
  119. #  You can use these new options on networks to make your configuration job
  120. #  easier. CUTCP always opens config.tel files as read-only, so you can mark
  121. #  your files as sharable, read only. Also, you can use the include= command
  122. #  in a $CUTCP environment variable, and on the command line.
  123.  
  124. #  *Note* that you can not include a machine specific parameter before
  125. #  name=default... This used to work in old versions, but is strictly
  126. #  enforced in this version.
  127. # --------------------------------------------------------------------------  
  128. #  This file is free form
  129. #  Separators are any char <33 and :;=
  130. #
  131. #  The form is keyword=value for each parameter.
  132. #  The first set of parameters refer to the whole program's defaults.
  133. #  These parameter values can be in any order.
  134. #  Following this are the individual machine specs.
  135. #
  136.  
  137. myip=128.153.28.65                      #  (bootp)
  138.                 #  myip types are:
  139.                                 #  bootp        - sends out a BOOTP request for your IP
  140.                                 #  rarp         - Uses reverse ARp to get your IP
  141.                                 #  xx.yy.zz.qq  - your IP address
  142.  
  143. vjc=no                # (no)
  144.                 # set  vjc=yes if you're running slip and
  145.                 # you want to use Van Jacobson TCP header
  146.                 # compression
  147.  
  148. splayc=no            # (no) ack. splay compression w/ vjc.. don't
  149.                 # use it, not standard, development option only
  150.  
  151. myname=userid            # put your userid here, used for Rlogin
  152.                 # PC-NFS version ignores this value and uses the name
  153.                 # that you specified to your pcnfsd.
  154.  
  155. netmask=255.255.252.0           #  needed if not using BOOTP. 
  156.                                 #  otherwise not needed because Bootp gets your netmask
  157.                 #  for you
  158.  
  159. hardware=packet            # (packet)
  160.                                 # harware choices
  161.                                 #  3com         - 3com 3c501
  162.                                 #  3c523        - 3com 3c523
  163.                                 #  wd800        - Western Digitial 800E
  164.                                 #  nicpc        - 
  165.                                 #  nicps        -
  166.                                 #  ni5210       - Micom Interlan NI5210 card
  167.                                 #  packet       - FTP packet Driver spec 
  168.                                 # (currently only Ethernet and Slip class devices are supported)
  169.  
  170. interrupt=2                     # hardware IRQ interrupt
  171. address=0                       # (0)
  172.                 # base memory address or packet driver class
  173.                                 # if using packet driver (0 == default == ethernet)
  174.                                 # or class=6 for slip
  175.  
  176. ioaddr=0                        # (0)
  177.                 # I/O address  or packet int vector if using packet driver
  178.                                 # If = 0 and packet driver, telbin looks for first
  179.                                 # packet driver found between 60H and 7FH
  180.  
  181. noarpme=yes            # Don't arp for myself before running? (no)
  182.                 # if yes, inhibits the initial arp request
  183.                 # for this IP address. However, if yes, won't
  184.                 # warn you if another user is using this IP
  185.                 # address. For some token ring systems, you'll
  186.                 # need noarpme=yes.
  187.  
  188. include="nul"            # if you want to include another file as part
  189.                 # of this one (you can nest up to three includes)
  190.                 # otherwise, don't use this option
  191.  
  192. domaintime=4            # domain name lookup timeout (first retry)
  193. domainretry=4            # domain name max number of retries 
  194. domainslist="clarkson.edu,aux.clarkson.edu" # domain name search path
  195.                                 # domain name lookup will attach each of these
  196.                                 # comma seperated suffixes to
  197.                                 # the end of the name you are looking for to
  198.                                 # discover the full name and IP address.
  199.                                 # so, looking for x tries x.clarkson.edu and x.aux.clarkson.edu then just x
  200.                                 # unless you use  x.  which ONLY looks for x
  201.  
  202.     ## Also, the fewer suffixes in the domainslist
  203.     ## the less time you will have to wait if you mis-type an entry.
  204.     ## Finally, try not to use a suffix like   .  or .edu or .com this will
  205.     ## waste a lot of time looking for a bogus host name if you mis-type an entry.
  206.  
  207. ## ----------------------------------------------------------------- ##
  208. ##   BEGIN MACHINE SPECIFIC PARAMETERS...                 ##
  209. ## ----------------------------------------------------------------- ##
  210.  
  211. name=default            # default entry sets defaults for all following
  212.                 # machines.
  213.  
  214. arptime=10            # arp timeout in seconds
  215.                 #
  216.  
  217. retrans=1                       # starting retransmit time out in ticks
  218.                 #   1/18ths of sec MAX 100, min 1
  219.  
  220. mtu=1024                        # maximum transmit unit in bytes
  221.                 #   outgoing packet size, MAX=1500
  222.  
  223. maxseg=1024            # largest segment we can receive
  224.                 #   whatever the hardware can take, MAX=4096
  225. rwin=2048                       # most bytes we can receive without ACK
  226.                 #   =TCP window size, MAX=4096
  227.  
  228. contime=20                      # timeout in seconds to try connection
  229.                 #   before returning error to user
  230.  
  231. #  Following are individual machine specifications
  232. #  Gateways are used in order that they appear in the file
  233. #  Nameservers rotate, #1, #2, #3, #1, #2 when a request fails
  234. #
  235.  
  236. # ********************************************************************* ###
  237. # Note: If you are using BOOTP above for myip=, then you do not need
  238. #       to enter a default gateway, nameserver, netmask etc (unless you want to)
  239. #       only IF your BOOTP server is rfc_1048 compliant. (Ask your Net Manager)
  240. #       You can use both bootp and entries here, in which case the entries in
  241. #       this file over-ride what BOOTP discovers. (however, bootp nameservers
  242. #       and gateways are ADDED to this file's list of entries
  243. # ********************************************************************* ####
  244.  
  245. #  Below this line, most of the communication parameters are obtained
  246. #  from the "default" host entry.  Those parameters listed for a host 
  247. #  override the default host values.
  248. #
  249. #  These are examples, replace them with the correct values for your site.
  250. #name=mynameserver
  251. #host=omnigate.clarkson.edu
  252. #hostip=197.001.4.2
  253. #nameserver=1
  254.  
  255. #name=backupserver
  256. #host=clutx.clarkson.edu
  257. #hostip=197.001.4.3
  258. #nameserver=2
  259.  
  260. #name=lastserver
  261. #host=n2ngw.nyser.net
  262. #hostip=128.145.198.2
  263. #nameserver=3
  264.  
  265. #name=mygateway
  266. #host=nysernet.clarkson.edu
  267. #hostip=197.001.4.1
  268. #gateway=1
  269.  
  270.  
  271. name=archie
  272. host=archie.funet.fi
  273.